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TELEVISION TYPEWRITER 
by Davtd Dodds 


I have two young boys who love to pound the keys of my Superboard,. To 
keep them amused (and protect whatever is in the machine), I make use of a very 
simple television typewriter routine in machine language. 

The routine is:- 


START JSR $FEED ; get a character from keyboard 
JSR SBF2D ; put it on the screen 
CLC 


BCC START ; branch always 


You can enter this routine, in seconds, anywhere you like as it is 
completely relocatable. For example to enter it at $0222, use the monitor and 
type 0222/20*ED*FE*20*2D*BF*18*90*F7.0222G Where * is carriage return, 


I was playing around with this one day and discovered that many of the 
machines graphics characters can be displayed by using the CTRL key in 
conjunction with other keys. Carriage return and line feed keys still act as 
normal so I started composing pictures. 


The program below will introduce you to a few of the new friends I made 


while fooling around, While the program doesn't do a lot it does give some 
idea of what can be produced with OSI graphics, I have created over 20 cousins 


to the ‘critters’ in this program. 


LIST 


1 POKES51,@:G0T037 

2 REM 3 PART GRAPHICS DISPLAY ROUTINE 

4 FORY=1 T0246: POKEHA+Y, ASC (MIDSCHAS( I}, ¥, 13) 

6 POKEBO+Y, ASCCMIDS(BOS(1),¥1)) 

8 POKEFE+Y, ASCCMIDS (FES (1,35) 23) SNEXT? RETURN 
9 [=9:K=1 :605UB4 :FORI=1704 

18 FORK=4T01STEP-1i :GOSUB4SNEXTK: f 

1] PORTS=STOQSTEP-1 SFORK=1 704 SG0SUBASNEXTR, T G07 
09 

12 REN DATA FOR GRAPHICS:NOTE REPITITIVE NATURE 
OF DATA 

15 REM BABUG CAN EASE TYPING IF YOU ARE SMART 

14 DATA 321 32) $2132 Gs Gs 32) 22, Se Se 2A, 2b 22, 
S21 S21 S21 by T 

15 DATA 32:32) 32152) 19) 21 

28° DATA 3 3215 532150 1ihere On oer er oerder Qher eda 
1321 dey er oer 2ber 2A9 

Zo DATA 32, 32732) 32) 242, 245 

38 DATA B21 21 GLI Oe 1262; 242, B21 27 Ol7 Oe 1 242, 262 
121027 oe th? 321 2621 242 

SO DATA 32122, 32) 32) 242) 242 

AQ DATA 32:32: 321 32) 249, 262) 321 32a Sey 52, 285, 262 
1527 dey 2 S21 2491 242 


All manner of things like buildings, 
Try it for yourself. You never know what 


characters can be created as well, 


45 faya 321g Ser: SF) 321 245, 2h? 

46 GOTOSS 

SQ DATA 32:32) 321 32s 245) LOS B21 S21 See 32y 265) 205 
i] 2) S22 oe S21 265}, 265 

a5 DATA B21 ere yoey Lar 245 

57 PRINTCHRS(127):REN DABUG SCREENCLEAR 

SO LL=32 :SCREEN=9297 2: IFPEEK (65586) =1THENLL=B4: 
SCREEN=53844 

59 DIMFES(4, 43 SHAT=SCREEN: BODY=HAT+LL SFEET=BODY 
+L 

62 FORJ=1 7024 :READC:! HAG (43 =HAS(4) +CHRE CL) SNEXT 
61 FORJ=17024:READC: BO$(4)=BO$ (4) +CHRS (CL) sNEXT 
6? FORI=1702:FORJ=17024: READ: Fd 1) =F 4 (1) 4CHREC 
CUINEXTS, I 

6 FORI=3TOOSTEP—1 SHAS CI) =RIGHTS(HASCI41), 23) +" 


64 BOSCTS=RIGHT$CBOS(T+1),23)4° “INERT 

és FORJ=i TOS: FES (4, )=FS C2) SNEXT 

GE FES(4, 4)=FE$ (4, 2) 

67 FORT=3TOQSTEP—i sFORJ=4 TOL STEP-12FES(I, J)=RID 
HTS(FES(I +1, J}, 25)+" ° 

GE NEXTS,T:PRINT® MGORTIAN TWO STEP"? PRINT? PRT 
NT: Gb07O9 

OK 


flowers, border patterns and fancy 


you will discover. Be wary of 'CNTRL J' and 'CNTRL M', 


TRANSFERRED FROM FRONT PAGE 


We thought we would save ourselves some time and energy by putting 
Christmas greetings on the front page, but there are a few odds and ends we 
think you should know, 


When writing or ringing COMP-SOFT for prices on goods, please remember to 
give your name and state that you are a member of KAOS, otherwise you will be 
quoted and charged the normal price. As a matter of interest, COMP-SOFT will 
be closing on 23rd December 1982 and re-opening on 17th January 1983. Let's 
hope George doesn't become a member of the Greek army. 


Would SYM members please note that Brian Campbell has a new phone number 
03 211 4793. 


For those people who did not read the front page last month, we repeat - 
there will not be a meeting in December. The closing date for articles for the 
next newsletter will be the 14th January 1983, 


$ret he -e eie ie  f e ies 


A LETTER FROM EARL MORRIS 


oe ee ed 


Dear Kaos, 


The last several issues of your newsletter had questions and comments on 
the now famous OSI Garbage Collector Bug. You have quoted that the code from 
PEEK appears to solve the problem. I have heard no complaints. Enclosed ts a 
hex dump of the code tf any of your readers want to put tt tnto EPROM, 


Some people have been having problems replacing ROMs with EPROM on the 
Superboard. OSI has connected phase 2 clock to pin 21. Some brands of 2716 
objeet to thts treatment. Most will work with a system clock of one meg, but 
fail at faster CPU rates. Even some 2716-1's will not work properly. The 
solution, as pointed out by David Jones in the August 1982 tssue of PEEK, ts to 
connect pin 21 of the EPROM to & volts. So tf you have had trouble replacing 


OSI's ROM, try thts fix. 
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NEWSLETTER OF THE OHIO SUPERBOARD USER GROUP, 146 YORK STREET, NUNDAH, 4012. 
A FAST ACCESS CARTRIDGE SYSTEM by Bruce Dykstra. 


The aim of this project was to provide at minimal cost, a system to access any 
program on a tape within 20 seconds under software control. 


The recorder used is a standard 8 track car player minus the audio electronics. 
The one actually used was an AWA Clarion transport which cost $28. Tapes are 
available from Tandy, and they can always be rewound with high quality reel-to- 
reel tape for better performance. 


Basically, the operation of the system is as follows. 


Track l,head 1 holds the program to run the system, and also contains an index 
of what is on the tape and at which locations. Using a VIA for sensing, the 
computer has inputs from track and head selectors to find the correct track. 

A counter counts each rotation of the flywheel. 


Say the program you want is on track 3, head 2, at 200 counts. The computer 
program peeks and pokes the track select until it is on the correct track, 
selects head 2, and turns on the fast forward motor. When the count reaches 
190, the fast forward motor is switched off, and the play motor is turned on. 
The correct program then loads when the filename is found. 


The recording technique used is NRZ, which makes for simple circuitry and works 
fine at 1200 Baud and may even go higher. 


Having loaded the program, the tape mechanism goes to fast forward back to the 
start of the tape, resets the counter to zero, and stops, ready for the next 
use. | 


Following are some of the circuits used in the device. More information is 
available from the User Group or the author at 27 Smith St, Ulverstone. 7315. 
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SOFTWARE REVIEW - Personal Calendar. 


Personal Calendar is a program requiring 8k. It comes on the OSI label and is 
written by David Tewksbary. The program itself occupies 4k, leaving 3k space 
for appointments. On running, a menu appears. Options are Find, Add to, or 
Review appointments. There are three data fields, Date, Time and appointment 
details. You can also delete appointments, and save future appointments to 
tape as data statements. The program does it all neatly and efficiently, but 
the processes are simple, and anyone who has fiddled with data storage and 
retrieval would have no problems writing their own routines. 

As with all Utility programs, one has to ask how useful it really is. I think 
on reflection, that I would prefer a shapely secretary to keep my appointments 
in order. Personal Calendar is in the OSUG library at the usual postage rates. 


Merry Xmas and a Happy New Year, 
Ed Richardson. 


THE RABBLE 65 


DESIGN CRITERIA, to produce a single board, 6502 based, OSI compatable computer 
as a companion board to the RABBLE Expansion board, Features to include: 
integral keyboard, FDC, modem and 6845 video, The following information 
indicates a configuration that is similar to the Superboard or Cl, 


NORMAL CONFIGURATION 
16K user RAM 0000 - 3FFF 6116 (eight) 
2K user RAM C800 - CFFF 6116 
2K video RAM DOOO - D7FF 6116 
128 bytes system RAM at C400 - C47F 
8K ROM A000 - BFFF 2732 (intend for BASIC or FORTH) 
8K ROM EOOO - FFFF 2732 (lower 4K user ROM, monitor extensions 
etc, Locations FOQOQO-FO01 and FCOO-FCO1 are decoded independently for 
serial 1/0. The upper 4K will be arranged so that main subroutine 
entry points are maintained to give maximum software compatibility, ) 


MONITOR EXTENSIONS will include; 
1, Disassembler 
2. GTBUG screen driver/editor (by Tony Durrant) 
3, Trace facilities | 


MAIN FEATURES 

Integral keyboard which may be seperated and used remotely via a 16 way ribbon 
cable 

6845 CRT controller (later versions may use the 6545) 

Standard display formats will be 32X32, 64X32, 80X24 (option for those with 
good quality monitors) 

Included on the board is an OSI compatable Floppy disk controller using the SMC 
9216 data seperator, the connecting cable to the drive is via a 50 way 
connector which can be strapped to suit the normal 8" drives or the MPI 5,25" 
drives, 

SERIAL 1/0, on board 6850 ACIA for cassette and printer via RS232 port with 
selectable baud rates from MC14411 baud rate generator. 


By moving the screen driver to block F, we have opened up a page at the 
top of BASIC in ROM, extensions so far are; 
CLS (clear screen) 
TRON,TROF (trace on/off) 
RENUMBER (renumbers lines in BASIC including GOSUB and GOTO) 
AUTO (auto increment for line numbers) 


The system will be supplied with three manuals; 
1, HARDWARE (including all circuit diagrams) 
2. SYSTEM SOFTWARE (including source for monitor) 
3. APPLICATION SOFTWARE (documentation for ROM BASIC, FORTH etc.) 


Expected costs, a minimum system should cost approximately $300 assembled, 
Built as a minimum disk system, together with the RABBLE expansion board, and 
including a 5.25" drive, power supplies etc. the cost should be less than 
$1000. The first productions versions should be on display at the February 
KAOS meeting. | 


Ray Gardiner and Bill Chilcott would welcome any suggestions or queries 
from KAOS members.... 


MODEMS 
by Ed Richardson 


In the October "SUPERBOARD", we offered some modems. There are about 30 
left and they are free, the only cost being registered postage to your address 
plus 60c for a handbook. 


These modems accept RS232 levels, have 2kV opto-isolation between computer 
and line, features like DCD, RTS, and CTS, and originally cost several hundred 
dollars. They were used until recently by a large Australian corporation. 
Built in 1972, they do not use modern FSK techniques needed to access T.A.B. 
but are a reliable way to communicate from member to member. 


If you are interested in obtaining one, write to me giving some details of 
your OSI system and what modifications and additions etc, that you have made. 
Include your telephone number and a SAE. 


On January 3lst, I will return your SAE's with details of costs for 
postage to your area. (Between $7 and $9.) Should I receive more requests than 
available modems, I will conduct a draw. 


This offer is open to all KAOS members, as are other products mentioned in 
SUPERBOARD, such as the Character Sets, Eprom Extender board, Extended Basic 
Commands tape and BASIC 3 and BASIC 4 EPROMs. 
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AUTO BOOT AND MENU FOR PICO DOS 
by Jeff Rae 


Due to the interest shown in the Hidden File article in KAOS Vol 2 No 12, 
I have written two programs which will give you PICO DOS disks with 9 files and 
auto-boot of file l. 


The first program has to be entered with the 0OS65D3 DOS. This is the 
program which takes the tracks of the original PICO disk, modifies them and put 
them back on the disk. To use this program run it and follow the directions 
that are displayed on the screen, Please note the program as written expects 
you to insert a blank disk, so it will intialize the entire disk. If you are 
using your original PICO DOS disk and you don't want it wiped then answer N to 
the question "ARE YOU SURE?", This will cause the program to write only to 
tracks 0, 1 and 2. One final note this program assumes that you have an 
original PICO DOS disk that has the Track 0 R/W utility on track 2. If you are 
not sure that it has, the following operation will transfer it off OS65D3 to 
PICO DOS. Boot up OS65D3 and type in the following exactly: 

EXIT(CR) 
CA 4200=13,1(CR) 
REMOVE OS65D3 DISK AND INSERT PICO DOS DISK 
SA 02,1=4200/5(CR) 
You now have the Track 0 R/W utility on Track 2. 


After running program ONE you have a disk that will automatically LOAD and 
RUN the first file. Now, using PICO DOS type in the program called 'MENU' and 
SAVE it to File l. 


To use your new disk, type in your program or LOAD it from an existing 
disk and save it by SAVE(2-9), (you cannot use File 1 it is occupied by the 
MENU). Then to add your new program to the menu, LOAD] (CR) RUN (CR) then 
press ESC. This will bring up the prompt DO YOU WISH TO CHANGE THE MENU? (Y/N) 
typing anything but Y will exit the program. An answer of Y will bring up a 
further prompt WHICH MENU ITEM DO YOU WISH TO CHANGE? Just type the number of 
the file and then the new name. If you wish to delete a name type ''" ". The 
name of the disk can be changed by typing O then the new name for the disk. 

You will find that you cannot change item 1 as the program assumes that it will 
always be MENU. 


PROGRAM ONE 


18 BS=CHR$(183+" THEN PRESS ANY KEY" 

20 X=15: GOSUBIOS 

38 PRINT"This program when run and instructions 
followed wilt" | 

48 PRINT "modify a PICO DOS Disk so that it will 
handie " 

5@ PRINT'S Files and auto boot in first file" 
68 PRINTBS: X=18: GOSUB28@ : GOSUB3 18 

78 AS="REMOVE DISK AND INSERT PICO DOS BISK":60 
SUBZ98 

98 GOSUB318 

108 DISK!"EX 4iFD-@O":DISK' "CA 4ARM=O1,1° =DISK! 
"CA 5288=82, 1" 

118 A$="REMOVE PICO DOS DISK AND INSERT BLANK 9 
TSK" :GOSUBZ98 

138 GOSUB318 

148 PRINT“BEWARE |!!! The next operation will o 
verwrite the disk" 

150 PRINT"in the drive. Have you inserted the b 
lank disk" 

168 DISK! "IN" 

178 DISK! "NEM 4679, 4679" 


LEB PRINT#HS, "8955" :CHR$ (12) ;CHRS (12) SCHRS C13) §" 
LOADL" :CHRS(133; 
198 PRINT#S, “POKES36, 186" CHRS(58) 3 “POKES37, 255 


195 PRINT#S, CHR$(S8) "RUN" SCHREC 13) 

200 POKE17871, 1215 POKEL 7872, 46: POKE1 7877, @: POKE 
17648, 9 

218 DISK!"SA Qi, 1=4AB8/8" =DISK!"SA @2, 1=5288/5 

220 DISK! "NEM SAQ@, SAGA" 

258 PRINT#S: "EXIT" SCHRSC13)3°CA @200=82, 1'' sCHRS 
(1393 

248 PRINT#: "GO 208" sCHRS(13) "2"; CHRS$(13)3 
208 PRINT#S, "W6200/2200, 8" SCHRSC13) 3 "E*sCHRS13 
y3 

268 PRINT#S, "GO FFQ@Q"SCHRE(13); 

278 DISK!"10 10,282" 

208 END 

298 X=15 SGOSUBSO@: PRINTAS: PRINTES:X=15 :GOSUB300 
> RETURN 

308 FORY=1TOX=PRINT = NEXT = RETURN 

S18 DISK!"GO 2528" RETURN 
OK 


@ DATA"BLANK DEMO : 

1 DATA"MENU i 

2 DATA" : 

3 DATA" : 

4 DATA" x 

3 DATA" : 

& BATA" : 

7 DATA" . 

§ DATA" : 

9 DATA" : 

3G PRINTCHRE (127) 

188 REM SET UP FOR Ci-P OR C4-P 

185 [FPEEK (65506 )=Q@THENL=32:(01=5401 G4+PEER (69584 
+ :O0T0128 

11@ L=64 2Ci=35040+ PEEK (E5504 3 

120 WI=PEEK( 69585) sIFPEEK(S7@88) (127THENWI=31 °° 
OKES6832, @:FLAG=259 

138 C2=(C1-24e_) +INT(CWI-23) £2) 

299 REM READ NAMES AND PUT GN SCREEN 

308 FORK=Q709: READAS(X} SNEXT 

S1Q FORK=QT09: TF X() @THENPOKECE+( (Xe 245 L547, X+ 
43 

Sue FORY=1 TOLEN (A$ (CX) SPOKEC 2+ ( CXec+ Se 454Y, 8 
SCCMIDSCAS(X), Ys 13) 

368 NEXTY: X 

399 REM DRAWS BORDER AROUND MENU UNTIL KEY PRES 
SED 

408 7=164 

418 FORK=87023: POKEC2+X) 7: POKEDS+ (224_ 423-0, 2: 
POKEC2+23+X#L, Z 

470 POKEC2+((25-X)4L),Z 

438 GOSUBSO@@:REM SEE IF KEY PRESSED 

440 NEXT = Z=INTCRND (295) #2544 1) 

450 GOT041@ 

499 REM TEST TO SEE IF KEY PRESSED 


Notes on the MENU program: 


The maximum length of a file name is 14 characters. 
border drives you crazy it can be disabled by 380 GOTO 600 


lines 399 to 520. 


MENU 


288 POKESS@, 1 :KB=57886 

318 POKEKB, FLAG: P=PEEK (KB) s TFFLAG=BTHENP=255-P 

328 A=PAND254:=POKES38, 8: [FA=@THENRETURN: REM NO 
KEY PRESS 

399 REM GET CHARACTER FOR KEY THEN LOAD AND RUN 

THAT FILE 

BBO GOSUBS@O: TFA=27THENGOTOLOB8=REM GOTO CHANGE 

MENU IF ESC PRESSED 

B1@ POKE119@6, A: POKESE 79, 121 :POKESEEA, 46: PRINTC 
HR$(127)3 POKESBE 52: 1 

628 POKES36, 206: POKESS7,27 END 

799 REM GET CHAR FROM KEYBOARD 

OB@ POKE11,0: POKEI2, 253: X=U5R(X) :A=PEEK (S31) 2 RE 
TURN 

999 REM EXIT OR PUTS NAME IN BATA STATEMENTS AT 

@709 

1OB@ PRINTCHRS( 127): POKESGES2: 1 

1685 PRINT*CHANGE MENU ? (Y/N)"S GOSUBE@Q: IFAY)8 
QTHENEND 

1i@ PRINT"WHICH MENU ITEM DO YOU WISH TO CHANG 
ES3t INPUTA 

1813 IFA (BORA) SORA=1 THENGOTO1818 

1220 INPUT"NEW ITEM "3A = TFLENCA$)) L4THENDOTD 
828 

1838 F=757:FORX=8TOA 

1825 IFPEEKCF)() LEU THENF=F+1 60701825 

1839 F=F+i 

1B4@ NEXTX:FORX=1TOLENCA$) :POKEX+F, ASC (MIDS$(AS, 
XyL))SNEXT 

1845 FORY=F+XTOF +14: POKEY, 32 SNEXTY 

1O64 PRINT*ANY NORE CHANGES" :G0SUBEQR: IFA=S9THE 
NOOTOiA1a 

1865 SAVE 

1878 RUN 
OK 


If the flashing 
or by deleting 


If you have any problems with these programs for a small copy charge you 


can get them from the disk library. 
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- ASSEMBLER ENHANCEMENTS 
by Davtd Dodds 


Users of the OSI assembler may be interested in some enhancements which 


are now available, 


The first offering is an extension to the RESEQUENCE command written 
entirely in the psuedo code which comprises so much of the assembler. The new 
code allows user defined start and increment values to be set when resequencing. 


The command format is: 


R(esequence)start value,increment value 


9 


Next page please 


The routine first sets default options of 10 for both start and increment 
then checks for user values. Full syntax checking is carried out for each of 
the 4 legitimate combinations which may be used namely: 


R start=10 inc.=10 
Rnnnn ~start=nnnn inc. =10 
R,mmmm start=10 inc, =nnnn 
Rnnnn,mmmm start=nnnn inc. =mmmm 


User values are initially checked to ensure that they do not exceed 65536 but 
no check is made for rollover during resequencing. The original routine did not 
have this facility and providing the test would have required a complete 
rewrite. No harm is done as the lines remain in the same place in memory as 
they were before resequencing (unless you save and reload text). 


The new routine allows greater flexibility in that by numbering source 
code files with different values it is possible to concatenate them in a 
desired sequence. The catch is a loss of 48 bytes of precious memory! 


About 12 months ago I added a modification to my assembler which was 
published in PEEK(65). The modification produces error messages instead of 
numbers. Investigation of the assembler has suggested a different method of 
detecting the occurrence of an error. By patching into the code which 
originates error messages and using a combination of psuedo code and machine 
code the error testing is made redundant. When an assembly error occurs the 
usual E# message is printed then a short form description of the error type. 
Approximately 1 page of memory is required to implement this mod. 


I will make the source code for these routines available to any one who is 
interested. Send a stamped addressed envelope for print out only or $2 to cover 
cost of cassete and postage to David Dodds 9 Duke St, Ashburton, 3147 Vic. 
Complete instructions for implementing the modifications either for cassette or 
disk versions will be included. 


At the time of writing further enhancements are being developed (such as 
autoline numbering). Any routines completed in the intervening period will also 
be included. 


It certainly was. The front row hecklers, (the Rabble Bored), were in 
fine form?!*?*! First, welcome to the three new members who made themselves 
known at the meeting and to the others who didn't. 


Special guest, Bruce Coburn, gave a long talk and short demo of the 
Proton, the new BBC personal computer. We saw a very impressive display of 
colour graphics and were told all about why the BBC needed such a product, even 
if we didn't want to know. With due respect, Bruce is a very knowledgable and 
informed man, but he did tend to waffle-on about the less needed information 
and had to be cut short, leaving a lot more useful info unsaid. 


Stewart Thomas, one of our young and very bright members, has another 
software mod to add to his growing collection, lower case BASIC that is 
recognised by the system. The first letter of each string is displayed as a 
capital and all others up to a carriage return or space, are lower case. The 
mod will even read a tape correctly and list to the screen in the new 


upper/lower format. eee Pape Diense 
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Michael Lemaire, another very bright if noisy member, demonstrated what 
can be done with standard OSI graphics. The display appeared to be HI-RES but 
was in fact standard OSI resolution. Pictures of various well known space 
ships drawn with careful manipulation of the graphics set looked great. 


Ray Gardiner had the RABBLE 65 (the new OSI compatible single board 
computer) up and running, great stuff Ray. The now very infamous Tony Durrant 
has his 8P up for sale and any reasonable offer, around $3500, will be 
considered , (I wish I had the money). Micom has a bulletin board running for 
those of you with modems. The cost is simply your phone call. The phone 
number is 03 762 5088 and the format is: 300 baud, 8 bits, no parity and no 
stop bit. 


Joystick standard....(John Whitehead wrote this, not me)...Chief joystick 
designer got together with the Turtle man and the Tape maker, the three decided 
to standardize on 'C4P joystick B' for the club's single player games, (see 
KAOS April 81, July 81, Aug. 81). No agreement could be reached on 2 player 
games as the 'C4P joystick A' uses the number keys decoding. The club games 
are going to be modified for joystick use and the Tasan video board. The 
‘joystick B' is wired to the keyboard as:- W=fire, F=down, R=up, T=right, 
Y=left. 


With GTBUG running successfully in the RABBLE 65 and the sudden appearance 
of a working version of George's assembler, I have no serial , saga nor tale to 
tell this month. What a shame, I was beginning to enjoy the stories myself. 
Well, until some time in 1983, from me, a very merry Christmas and a prosperous 
and fruitful (programming wise) New Year to you all. 


‘ She She She SLE Ste SHE SBE SLE Sd St WE ZLE ALE ALE OL 


DEAR PAUL, Christmas Edition 
by Paul Dodd 


Q. What are the ‘Standard KAOS' I/O port locations? 
A, NOTE: these addresses are from section 12, page 5 (1/0 decoding) of the 
Rabble Ozi Expansion Board manual. 


C000 - C003 Floppy disk PIA 

C004 - C007 User PIA 1 

CQ08 - COOB User PIA 2 

COOC = COOF Calculator PIA (or User PIA 3) 
C010 = C013. Floppy Disk ACIA 

C014 - CQ17 Prog. Sound Generator PIA 
C018 - CO1B Spare Cassette ACIA 

CO1C - COIF Not allocated 

C020 -— CO2F Real Time Clock Clear 
C030 —- COSF User VIA 1 

C040 - CO4F User VIA 2 


Some of these may be peculiar to the Rabble board, but they should give you a 
reasonable idea of the locations. 

Q. Is there an extended BASIC EPROM available for the Superboard? 

A. I have heard that the Queensland User Group (See the 'SUPERBOARD' section in 
this magazine) has an extended BASIC ROM called 'BASIC 5'. It would probably 
be advisible to contact Ed Richardson in Queensland (the address is on the 
'SUPERBOARD' page) and get more information from him. 


Next page please 
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Q. Is Pascal available for my 5.25" disk system with 24K RAM? 

A. There are three Pascal implementations available, Firstly there is PASCELF 
which is a very tiny PASCAL that will run on anything from a CIP with 8K and 
cassette to a C8P with 48K and dual 8" disks. Secondly there is a mini-PASCAL 
which runs on a CIP or C4P with at least 32K and one 5,25" disk drive. Thirdly 
for the big systems, there is UCSD PASCAL which is a full implementation 
requiring 48K and dual 8" disks. (There is a 5.25" version, but I know of 
no-one in KAOS with a copy of it.) 


Q. What are the track boundaries of BASIC, Assembler/Editor and Extended 
Monitor (ie. which track do they start on, which track do they finish on, and 
where are they loaded into RAM)? Is this information stored on disk anywhere? 
A. Both BASIC and the Assembler-Extended Monitor combination are three tracks 
ie. 6K long, and both reside in memory from $0200 upwards. If you have an 
OS65D disassembly or better still, a source listing, you will notice that the 
"ASM' command is located at S$2ADE and looks like this: 

S2ADE AY 05 ASM LDA #$05 ; First track number 

S2AEO 20 EE 2A JSR LDCMN ; Common load routine 

$2AE3 4C 00 13 JMP STASM ; Assembler entry point 


The 'BASIC' and 'EM' commands are similar. The 'LDCMN' routine is at $2AEE, 
and expects to find a track number in the accumulator, it then loads three 
tracks, including the one specified, and stores them from $0200 upwards. 
Incidently, the 'BASIC' (or 'BA') command is at $2AE6 and 'EM' is at $2B2F. If 


you load the Assembler, you automatically load the Extended Monitor and vice 
versa, 


Q. What are the numbers on the right of the screen when I run 'SCOPY'? 

A. These numbers are supposed to represent the number of pages free after 
loading each track, They are correct for the first few tracks but there is a 
bug in the program and they are incorrect after the first disk swap. 


Q. I would like to study disk BASIC. Is there a book similar to 'The First 
Book of OSI' (which is written for ROM machines) available for disk BASIC? 
Where else can I look for information? 

A. There is not, as far as I know, a disk equivalent to the book you mentioned. 
There is no easy way to find out about all the routines but there are plenty of 
articles in 'PEEK 65' and 'The Aardvark Journal’ outlining some of the 
functions of disk BASIC, and I think that there is a source listing of disk 
BASIC somewhere around. 


Here are a couple of questions that I haven't been able to answer: 


Q. On the standard system BASIC disk, there are about 30 bytes of code on track 
6, sector 2 (5.25" systems). This code is something to do with the keyboard 
location ($DF00), but can apparently be deleted with no adverse effects. What 
is it for, and is it ever used? 


Q. I have come across a problem when saving 8 pages of data on a track in more 
than one sector (ie. 2 sectors of 4 pages each). I can't do a 'DIR' on them 
(the system hangs), nor can I copy them, I've found (using the 'EXAM' command) 
that some of the data that should have gone onto the second sector was written 
to the space between the index hole and track start header. I've had partial 
success trying to correct this by changing location $270A (the delay between 
the index hole and the track header) from SOA to $09, can anyone shed any light 
on the problem? 


I have a partial answer, but I would rather wait until I know the whole story 
before publishing it. If anyone has a real answer, could they please send it 
to me, and I will include it as part of a later 'Dear Paul’ column. 


I hope everyone has a Merry Christmas, and a very Happy New Year. I look 
forward to seeing you at the January Meeting, 
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THE BEGINNING MACHINE LANGUAGE PROGRAMMER....Part 6 
by David Dodds 


During the writing of a series like this the author gets to ask all sorts 
of self indulgent questions (like why did I volunteer for this anyway). The 
question every author dreads is "what did I forget?"., Always you hope the 
answer is nothing.......-Not so.....you have been mislead....Well almost! 


This series is not really about machine language programming at all (so 
much for that title!). For the last few months you have really been learning 
Assembly Language. No one sane ever programs in machine language. After all a 
long string of binary numbers is very hard to understand. You have to learn 
about the machine instructions that assembly language symbolises in order to 
produce machine language programs, but even for learning these we use assembly 
language. 


Assembly language programs are made up of numbered lines containing 
mnemonics and their associated addressing notation. Sometimes a line will also 
contain special symbols, 

A complete program usually looks something like this: 

10 ; Screen Clear 


20.3 
30 *=$0222 
40 ; 
50 INIT LDA #$00 ; Set up pointer to 
60 STA TVPUT+1 ; Top left corner of 
70 LDA #$D0 ; screen memory 
80 STA TVPUT+2 
90 LDA #520 ; Blank chr. 
100 LDX #507 ; No of pages of mem. 
110 TVPUT STA SDOOO 
120 INC TVPUT+1 ; set up next address 
130 BNE TVPUT 
140 INC TVPUT+2 
150 DEX ;page completed 
160 ENDTST BPL TVPUT ; branch if not finished 
170 LDY #S$00 
180 TEXT LDA MESAGE,Y 
190 BEQ END 
200 STA $D365,Y ; for Cl 
210 INY 
220 BPL TEXT 
230 END - END 


240 MESAGE .BYTE 'READY',$00 
Since there will be a lot more assembly language programs on these pages in 
future it would be appropriate to digress a little and cover some of the 
special symbols which you will be encountering. 


Usually any places where values are stored are given names or labels such 
as TVPUT. In this way if you change the value or the location you don't have to 
change an entire program, just one line. This practise can also make programs 
far more readable; compare for example STA BUFFER,Y and STA $13,Y. Labels can 
also be used to identify branch entry points, tables, routines and subroutines 
either within or external to the program. 

eg. MOV.IT LDY #$10 

LDA (START) ,Y 
STA (END) ,Y 
DEY 
EN een te Next page please 
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Labels are usually a maximum of 6 characters long and start with an alpha 
character. The operator = (sometimes EQU) is used to assign values to labels eg 
START=$54, 


Somewhere before the program (and sometimes during it as well) a line like 
*=$0222 appears. This means that the code which the program represents is to be 
placed from $0222 onwards. The * symbol is specifying the origin of the 
program. | 


Assembly language programs should always contain comments, otherwise next 
time you come to read them you won't have any idea what the code is doing. 
Comments are usually preceded by the ; symbol. Sometimes ;° is used on its own 
to space out program segments and make the program more readable. 


Values within programs can usually be expressed in a number of ways. 
Depending on the context, values might be expressed as ASCII characters, binary 
numbers, in decimal, petal or in hexadecimal. The machine code A9 43 could be 
derived from any of the following phrases in a program: 


LDA #'E ASCII 
or LDA #$43 Hexadecimal 
or LDA #67 Decimal 
or LDA #Z01000011 Binary 
or LDA #@103 Octal 


The symbols ' $ % and @ indicate the type of value being represented. LDA 

#'E would clearly be more appropriate in a text or command mode situation while 
401000011 might be used when preparing to test the condition of say an output 
port. 


Arithmetic operators can also be used in an expression eg INC TVPUT+2 
indicates that the location to be incremented is 2 locations past the position 
TVPUT. The operators +, -, / and * are all valid. 


When it is necessary to include data such as constants or text it is usual 
to prefix this data using .WORD or .BYTE. These symbols are referred to as 
directives. 

.WORD is used when an absolute address is to be placed in memory. The 

address is placed in standard 6502 low byte, high byte format. If only 2 

digits are specified then a high order value of $0 is assumed. 

.BYTE is used for single items of data. More than one byte may be. 

specified on a line but successive values are separated by a comma. ASCII 

strings however may be given without the comma. 


The completed program is usually referred to as a source listing. Another 
type of listing known as an assembly listing includes the start of memory at 
each line and the Hex characters which represent the machine language produced 
by that line. This additional imformation is usually placed between the line 
number and the area used for labels. Since the machine code is listed on the 
assembly listing it can be used to enter the code into your machine by hand if 
you do not have an assembler. 


Future listings will be source listings. I suggest that at first you hand 
code them and use the monitor to enter them in your machine. Since I will be 
endeavouring to teach programming techniques as well as assembly language the 
way future programs are presented might not necessarily be the best way to 
write them. Try experimenting with alternate methods of achieving the same 
result. It doesn't matter if it bombs you won't blow up you computer. The best 
way to learn is by your mistakes, 
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USER-FRIENDLY PROGRAMMING 
by Michael Lematre 


. Microcomputers are becoming increasingly important to people nowadays. 
Business people want to keep information where they can get at it quickly, to 
have their whole business at their finger tips. At home, people want to keep 
up with the Jones by having a trendy microcomputer; but they don't want to have 
to be programmers to use it, and the people in business probably don't have the 
time or inclination to become programmers. All this means that microcomputers 
have a very comfortable (and lucrative) niche in society -- as APPLIANCES 
rather than as ‘great powerful microcomputers' with 64K RAM and dual den: 
This means that they must be easily used as appliances, rather than needing a 
computer background to operate them, This is why ATARI has been so successful 
-- their programs don't rely on the user knowing what a byte or a sector is, 
themost knowledge you need to run an Atari software package, whether it is a 
game or inventory system, 1s how to push the start button. As a result, anyone 
can use it, and the market for the machine and software is huge. 


Recently I was asked to write a stock control system for a company with no 
previous computer background; thus the system needed to be as friendly as 
possible for the people using it. I came to a few conclusions while designing 
the system; 


(1) Write the system so that everything is obvious and all the information 
you need to know at a given point is on the screen in front of you. Not that 
you don't supply documentation; just that the user should not have to be forced 
to spend a lot of time learning the system or referring to the documentation. 


(2) Make it impossible to input a bad command. If the user gets an error 
message every time he enters a bad command he may get a little peeved or feel 
inferior. In the system I wrote, all commands are entered by 'pointing' to a 
menu choice with an inverse-video cursor. The user can only enter a menu 
choice; nothing else which could give an error. The concept of an illegal 
command does not exist. This was one reason why I chose to have commands 
entered by a menu system rather than a command-language style of command 
entry. 


(3) Arrange the system logically. The system should, if possible, copy 
'real life' situations. The user will feel more at home with something that 
makes sense and works the way he feels it should. My stock control system is 
arranged so the user decides what he wants to do (eg. look up records, enter a 
new record). He then enters what record he wants to operate on; item records, 
or supplier records, say. A record is displayed on the screen set up like a 
card file (yes, just like ‘real life). When a field is changed, the new 
contents are drawn up on the 'card'. 


(4) Be consistent. The user will get confused if one method of eg. 
command input, is used in one section of the package, and a different system 
used somewhere else. With a consistent enviroment, the user will be able to 
deduce how to use an unfamiliar section, because it will work in a similar 
fashion to the other sections he has used. 


This sort of user-friendly operation is not restricted to business 
packages. Other things, like games need them. There is nothing worse than 
starting up a game or word processor or whatever on my OSI and having no idea 
what to do, or what keys to press. But there are also many friendly programs 
around which are a joy to use, Byte Vol.7 No.4 (April 1982) has a lot of good 
information on this subject. 


(By the way, is anybody interested in an inventory system or stock-control 
program with point-of-sale and automatic stock update?) 
Contact Michael by writing C/O KAOS. 
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GOOD NEWS FOR OSI OWNERS 
by Michael Lematre 


If you looked at the benchmark summary in the November issue of APC, then 

you may have been a little upset by the C4P's apparently poor showing with a 
total run time of 25.0 seconds. Well, I tried out the benchmarks, and decided 
that they were run on a 1MHz machine. So if you have a 2MHz system, then your 
benchmark time is in fact 12.5 seconds, putting OSI second after the Olivetti 
(and faster than the BBC Micro!). It goes to show that newer is not always 
faster, 

Olivetti M20. .ccocccceccosccccell.» SEC, average, 
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IBM Personal Computer...ccccocecl/.6 

SIPLUS: Jl voeweaew ews eteeeseeee tee 
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Hitach1. Peaches ¢.s060.6G.00e sew wee Ie0 
On the individual benchmarks, the 2MHz OSI comes first on numbers 3, 6, and 7. 
We should all give thanks to Richard W. Weiland for making KAOS such an elite 
group of micro users, 
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THE BBC MICROCOMPUTER 
by Jeff Rae 


At the November meeting a BBC Proton was demonstrated by Brian Coburn from 
BARSON COMPUTERS, Unfortunatly the demonstration was cut ‘short due to the lack 
of time but we were treated to a brief history of the ACORN systems in general 
and the development of the PROTON. 

The PROTON on display was a model B which features a 2 Mhz 6502A micro, 
32K of RAM, 32k of ROM, cassette interface at 300 or 1200 baud, RS423 serial 
port, parallel ports for printers etc, high resolution colour graphics and many 
other features that add up to the very attactive package. 

We were also shown a range of the games software. The games demonstrated 
were a version of Ghost Muncher called Snapper and Defender, all of the 
software made extensive use of the high resolution graphics and sound to 
produce a game as good as the original arcade games, Other software available 
includes Forth, Lisp, Pascal, and a lot of educational programs. 

For pricing and further details contact: | 
BARSON COMPUTERS 86 Nicholson St. Abbotsford, VIC, 3067 Phone 03 419 3033 
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FOR SALE OR SWAP 


C4P - 8K, 300/600 baud, 1-2 MHz. Manuals and lots of programs including Cursor 
Control, Editor/Assembler, WP6502 and many games - most home grown. 
NTSC colour, sound. $550.00. B & W converted TV $50.00. 

Write to Peter Meulman, 


FOR SALE C8P $3500 (negotiable). Contact Tony Durrant on 03 428 4108 AH. 


24K Static Ram’ Memory Board, OSI 540 board. Has run without fault. Sell for 
$225 or swap for OSI compatable 5.25" or 8'' floppy disk drive. 
David Wilson 


I have a copy of OS65U V1.3 CD-74/CD-36 on 8" floppy to swap. I am interested 
in swapping it for a Tasker Buss kit - preferable memory board, I/O board or 
EPROM board. The floppy comes with the OS65U Reference manual. 

Contact Derryl Cocks, 


There was a typing error in the Ext Mon Formatted Output program on page 3 
of KAOS Vol 3 No 2. 1F58 should read 20AF1B and line 1F5B should be CA 


